Release 10.1A: OpenEdge Development:
Progress 4GL Reference

GET-CHANGES( ) method

Loads an empty ProDataSet object with changed rows from either a single temp-table or all temp-tables in another ProDataSet object.

Return type: LOGICAL

Applies to: Buffer object handle, ProDataSet object handle

Syntax

change-handle:GET-CHANGES(original-handle [, get-parent-mode ] )

change-handle

A handle to the ProDataSet object or ProDataSet temp-table buffer to receive the changed rows.

original-handle

A handle to the source ProDataSet object or ProDataSet temp-table buffer that contains the changed rows.

get-parent-mode

An optional logical expression where TRUE indicates that Progress get changed rows in a get-parent mode.

When TRUE, Progress includes the parent row of each changed child row in the ProDataSet object or ProDataSet temp-table (if any). If there is more than one parent level above the changed row, Progress includes the parent row at each level. In this case, the parent temp-tables must have a unique primary index that Progress can use to find the corresponding rows. If a parent row has changed, Progress copies both the before-image and after-image of the parent row. If a parent row has not changed, there will be no before-image of the parent row, and its change state (ROW-STATE) will be ROW-UNMODIFIED (0) or the Unknown value (?).

Note: When the relation mode of a parent is REPOSITION, no attempt is made to find that parent.

When FALSE, Progress does not include parent rows. The default value is FALSE.

The ProDataSet objects associated with the change-handle and original-handle must have the same number of temp-table buffers, and the definition of the corresponding temp-tables must match (that is, in the number of columns, data types, and so on).

Once the changed rows are loaded, Progress sets the ORIGIN-HANDLE attribute on the temp-tables in the receiving ProDataSet object to the corresponding temp-tables in the original source ProDataSet object. Progress also sets the ORIGIN-ROWID attribute on each of the before-image table rows created in the receiving ProDataSet object to the ROWID of the corresponding before-image table row in the original source temp-table. The MERGE-CHANGES( ) method and MERGE-ROW-CHANGES( ) method uses these values to match up temp-tables and temp-table rows during a merge operation.